万字实战轻松理解 Agent Skills、MCP、子代理、工作区,Claude Code 保姆级一周精通教程 04
万字实战轻松理解 Agent Skills、MCP、子代理、工作区,Claude Code 保姆级一周精通教程 04
来源:htmlDecode("爱AI的大刘")
原文链接:https://mp.weixin.qq.com/s/tjPtBlYUNhqbDD7_CRO6cg
别背概念,跟我操作完一个具体的工作流,就都会了。 ✍️ 作者: 大刘
📝 编辑: 大刘
🎨 排版: 大刘
很多人第一次用 Claude Code,会被一堆新词绕晕: ** 工作区、上下文、Agent Skills、MCP、子代理。 **
但这篇文章不是来解释名词的。
我想手把手带你用 Claude Code 做完一件真正有价值的事,跟着做,轻松理解这些复杂概念, ** 关键是学会用。 **
你会看到:Claude 不是只靠“聊天记录”工作,它需要知道当前工作区在哪里、能读取哪些文件、哪些规则要长期记住、哪些外部工具可以调用。 ** 这些加起来,才是我们真正要管理的上下文。 **
先说前提: ** 默认你已经通过 Trae 或者 Cursor 把 Claude Code 装好了。(还没装好的从教程第一篇开始!) **
你可以把这篇文章当成一次陪跑:跟着做完,你会看到计划、资料、报告和 PDF 都真实落在本地工作区里。
这篇是「Claude Code 一周精通系列」的第四篇。
第一篇 帮你装好了工具,加更篇(文末)搞定了订阅和防封。 第二篇 熟练了使用, 第三篇 学习了 skills。
** 这一篇,用一个真实案例了解一个工作流是怎么样。 **
** Claude Code 一周精通系列 **
第一篇:安装配置篇 —— 用自动化的方法装好配好,跑通第一个 demo
加更篇:原生订阅 + 防封篇 —— 原生 Claude 订阅怎么搞、怎么防封、最佳实践全讲透( 放在文章末尾了~ )
** 第二篇(本篇):日常使用篇 ** —— 核心用法、Prompt 技巧、高效工作流
第三篇:Skills 篇 —— 可复用的能力包,让 Claude Code 变成你的专属助手
第四篇:实战场景篇 —— 工作流全实战,大刘的独家落地经验
第五篇:方法哲学篇 —— 真正让自己从用 AI 成为 "懂" AI,熟练掌握 AI 思维和方法论
先定一个小任务
01
我们今天不用太复杂的工具对比,也不做很专业的行业报告。就用一个多数人都会遇到的需求:
我最近听到一个新领域,比如“具身智能”,但完全不了解。请帮我快速调研这个领域,输出一份 8 页以内的 PDF 入门报告,让我知道它是什么、为什么重要、有哪些关键概念、代表玩家、争议问题和入门资料。
这里的“具身智能”只是演示例子。你真正照着做的时候,最好换成自己职场里正在遇到的真实问题:老板提到的新行业、客户反复讲的概念、团队准备进入的新市场,或者你要做的内部分享主题。
这个任务刚刚好。因为现实里,很多时候我们不是马上要写代码或做决策, ** 而是先要快速搞懂一个陌生领域。 **
Claude 适合帮你搭一张入门地图, ** 再把资料、来源和结论整理成一个能保存的文件。 **
同时,这个任务也能把 Claude 的几个核心能力串起来:
- 工作区负责留下计划、资料、报告和 PDF。
- Agent Skills 负责给 Claude 一套做事流程。
- MCP 负责连接外部工具和服务。
- 子代理负责分工协作。
- minimax-pdf 负责把最后的报告变成 PDF。
你看,概念一下就不飘了。 ** 它们不是一堆高级名词,而是一条流水线里的不同工位。 **
后面你会看到,它们分别对应文件管理、流程调用、工具连接、任务分工和最终交付。
话不多说。直接开始。
第一步:在桌面建一个文件夹
02
先回到桌面,新建一个文件夹。
名字不用复杂,可以叫:
new-field-research-demo
或者更中文一点:
未知领域入门调研
这个文件夹,就是我们今天的本地工作区。
先别小看这个动作。很多人一上来就直接在聊天框里问 Claude, ** 聊完以后什么也没留下。 ** 今天我们不是闲聊,我们要做一个 ** 能交付的东西 ** ,所以先要有一个地方放计划、资料、报告和 PDF。
这一步的意义很简单: ** 先给我们要做的事情找一个家。 **
第二步:用 Trae 打开这个文件夹项目
03
打开 Trae,选择 Open Folder ,然后选中刚才桌面上的那个文件夹。
打开之后,你会在左侧文件栏看到这个项目。刚开始里面可能是空的,这很正常。
这里最重要的一句话是: ** Claude Code 不是在你的整个电脑里干活,而是在你当前打开的这个文件夹里干活。 **
这个文件夹, ** 就是今天的工作区。 **
后面 Claude 生成的计划、资料、报告和 PDF, ** 都应该落在这个工作区里。 **
这里顺便把“上下文”讲清楚。
对 Claude Code 来说,上下文就是它当前能看到、能读取、能引用的信息:这轮对话、当前工作区里的文件,以及后面工具返回的资料。我们把计划、来源、报告都放进这个文件夹, ** 本质上就是在给 Claude 补充上下文。 **
第三步:在 Trae 终端启动 Claude Code
04
接下来,在 Trae 里打开终端。就在菜单栏里找 Terminal ,选择 New Terminal 。
终端打开后,直接输入:
● ● ● claude
注意,这不是安装命令。你之前已经装好了。这里的 claude 是启动 Claude Code。
如果一切正常,你会看到 Claude Code 的对话界面。后面我们安装 skill、查看 MCP、创建子代理、让它写计划,基本都在这里完成。
这一步完成之后,你才真正从 ** “普通聊天”进入了“项目工作流”。 **
第四步:让 Claude Code 安装 Superpowers
05
接下来给 Claude 装第一套工具: ** Superpowers ** 。
它的核心价值不是“让 Claude 更炫”,而是让 Claude 做事 ** 更有纪律:先想清楚,再写计划,再分工执行。 ** AI 最怕的不是不会做, ** 而是你需求还没想清楚,它已经热情洋溢地写完了。 **
这里不用让小白自己判断该复制哪条命令。直接让 Claude Code 帮你安装:
● ● ● 请根据这个 GitHub 仓库帮我的 claude code 安装 Superpowers skill:https://github.com/obra/superpowers,并且在 Claude Code 中启用
Superpowers 是一个技能包,里面有好几个技能。今天不用研究 Superpowers 的全部能力,只用它的三个技能:
- 用 /brainstorming 顾名思义,头脑风暴,帮我们把需求问清楚。
- 用 /writing-plans 把需求自动落成计划。
- 用 /dispatching-parallel-agents 把任务拆给多个 Agent 协作。
真实使用的时候,直接在 Claude Code 输入框里敲斜杠调用 skill。
重点不是命令多酷,重点是这套节奏: ** 先澄清,再自动生成计划,再按计划执行。 **
注意,重启 claude code 才生效。
第五步:让 Claude Code 安装 minimax-skill
06
接着安装第二套工具: ** MiniMax skills ** 。它负责最后一步:把我们的报告做成一份更像正式交付物的 PDF。
同样,不需要你手动复制安装命令。直接对 Claude Code 说:
● ● ● 请根据这个 GitHub 仓库帮我安装 MiniMax-AI/skills,https://github.com/MiniMax-AI/skills,安装在当前目录中,并且在 Claude Code 中启用!
根据指令完成即可!
MiniMax-AI/skills 这个也是技能包,里面包含各种用于工作的 skills。
其中 minimax-pdf 能做的事不少,比如生成 PDF、填写表单、重排文档。但今天我们只用一个能力: ** 把报告变成 PDF。 **
后面真正调用的时候,也用斜杠:
● ● ● /minimax-pdf
别把它神化成“任何草稿一键设计大奖”。 ** 它更像最后的排版打印店。 ** 你给它越清楚的内容、结构和风格要求, ** 它越容易产出像样的文件。 **
注意,重启 claude code 才生效。
先分清三个概念各管什么
07
到这里,我们已经装好了两个 skill。先暂停 1 分钟,把接下来会用到的三个概念分清楚。
它们不是一类东西:
1. ** Skills 管流程 ** :告诉 Claude 这件事应该按什么步骤做。
2. ** MCP 管连接 ** :告诉 Claude 当前能连接哪些外部工具和资料来源。
3. ** 子代理管分工 ** :把一个大任务拆给不同角色处理。
放到今天这个 PDF 任务里,就更清楚了:
1. /brainstorming 负责把需求问清楚。
2. /writing-plans 负责把需求整理成计划文件。
3. /dispatching-parallel-agents 负责让多个角色协作。
4. /minimax-pdf 负责把最后的报告生成 PDF。
所以, ** Skills 解决的是“怎么做” ** 。你不需要记住它内部有多少文件,只要知道:安装后可以用 /skill-name 调用一套流程。
接着看 MCP。
MCP 解决的是“能连什么”。比如浏览器、资料库、项目管理工具、代码仓库、数据库,都可能通过 MCP 接进 Claude Code。
今天我们不开发 MCP,也不配置复杂权限,只看,在 Claude Code 里输入:
● ● ● /mcp
如果你前几个教程也跟着大刘的,那这时候你已经有 Minimax 的 MCP 了。
如果列表是空的,也不用慌。它只说明你现在没有配置项目级 MCP,不影响我们继续理解这条工作流。
最后是子代理。
子代理解决的是“谁来做哪部分”。
注意,初始状态下你不一定已经有这些子代理。没关系,后面执行到多 Agent 协作时,我们会让 Claude Code 按任务需要创建或调用对应角色。
所以你先记住这一句就够了: ** Skills 是流程,MCP 是连接,子代理是分工。 **
开始干活:先把需求问清楚
08
前面的工具装完了,概念也够用了。现在开始做任务。
我们先不要直接说“帮我调研具身智能,写个 PDF”。 ** 这个需求太粗了 ** ,Claude 当然能写,但很容易写成一篇 ** “看起来很完整,实际很空”的报告。 **
所以先让 Superpowers 帮我们澄清需求:
如果你只是跟着练,可以继续用“具身智能”。如果你想让这篇教程立刻变成自己的工作成果,就把下面的“具身智能”替换成你职场里正在面对的那个领域。
比如:
● ● ● 具身智能 → 公司准备关注的新赛道
具身智能 → 客户最近反复提到的行业概念
具身智能 → 你要做内部分享的新主题
具身智能 → 你准备进入但还不懂的岗位方向
● ● ● /brainstorming
我想做一个调研项目:
我想快速搞懂一个自己完全不了解的新领域。
这次示例领域是:具身智能。
请采用多 Agent 的方式为我广泛的搜索资料。
最后使用 minimax-pdf skill输出一份 8 页以内的 PDF 入门报告。
读者是完全没有基础的小白,也就是现在的我。
请先问我必要问题,
帮我把需求澄清到可以执行。
它可能会问:你为什么要了解这个领域?是为了工作、投资、学习,还是单纯跟上趋势?你更关心技术原理、商业机会、代表公司,还是普通人能不能参与?要不要聚焦中国市场?需要讲到多深?要不要给入门资料清单?
这一步很像一个靠谱同事在接需求。他不会一听你说“做个报告”,就直接消失两小时。他会先问: ** 你要给谁看?什么时间要?做成什么样算完成? **
** AI 不是许愿池。你扔进去一个模糊愿望,它就会吐出一个模糊结果。 **
让计划自动落盘
09
需求问清楚之后,不要自己再复制一大段要求去“手动写计划”。
Superpowers 的正常节奏是: /brainstorming 把需求澄清到足够清楚后,会继续进入 /writing-plans ,把刚才确认过的内容自动整理成计划。
你只需要补一句保存位置:
● ● ● 请把刚才确认好的需求自动落成实现计划,
保存到 plans/new-field-research-plan.md。
计划里请包含:
目标、范围、资料来源策略、子代理分工、输出文件、验收标准。
** 计划不是束缚 Agent 的绳子。计划是给 Agent 铺好的轨道。 **
很多人用 AI,一直停留在 ** “我说一句,它答一句” ** 。这当然也能用,但只要任务稍微复杂一点, ** 就容易跑偏。 **
计划的作用,是让 Claude 明确知道: ** 我要做什么、不做什么、谁负责什么、最终产物是什么、怎样算合格。 **
对小白来说,计划文件还有一个隐藏好处:你可以打开看,可以改,可以发给别人,也可以下次复用。 ** 这就不是一次聊天了,这是一份项目资产。 **
让多 Agent 协作搜资料
10
现在有计划了,可以派小队干活了。
● ● ● /dispatching-parallel-agents
请按照 plans/new-field-research-plan.md 执行调研。
请用 3 个子代理协作:
researcher:搜集这个领域的定义、核心概念、发展脉络、代表玩家和入门资料。
fact-checker:核验定义、数据、代表案例、政策和时间点是否有可靠来源。
report-writer:根据已核验资料整理一份小白能看懂的入门报告。
请把原始资料保存到 research/raw-notes.md。
请把来源链接整理到 research/sources.md。
请把报告初稿保存到 report/new-field-guide.md。
执行过程是这样!
我这里故意写的是“协作”,不是保证“所有 Agent 一定同时开跑”。不同环境、不同权限、不同工具版本,实际运行方式可能不一样。
但核心思想不变: ** 把任务拆给不同角色。 **
researcher 像 ** 资料员 ** ,负责找材料。fact-checker 像 ** 核验员 ** ,负责检查材料靠不靠谱。report-writer 像 ** 编辑 ** ,负责把散乱材料变成读者能看懂的结构。主 Claude 则像 ** 项目经理 ** ,最后把大家的输出合并起来。
三个就够了。小白第一阶段要学的是 ** 把任务拆开,不是把系统搭到天花板。 **
资料一定要有来源
11
AI 报告最怕什么? ** 不是写得不漂亮,是写得太漂亮,但不知道哪来的。 ** 看起来句句有道理, ** 细问全是空气。 **
所以在上一步我们一定要让它留下 sources.md :
● ● ● | 主题 | 来源标题 | URL | 用途 | 核验状态 |
|---|---|---|---|---|
| 领域定义 | 权威机构或专业媒体解释 | https://example.com | 核验基本定义 | 已核验 |
| 代表案例 | 公司官网或可信报道 | https://example.com | 核验案例真实性 | 已核验 |
这一步非常朴素,但非常重要。因为从这一刻开始,你的报告不再是 ** “Claude 说” ** ,而是 Claude 帮你整理了资料, ** 资料有出处,结论可以追溯。 **
** 闲聊可以爽,工作要能交代。 ** 尤其是领域定义、市场规模、代表公司、政策变化、关键时间点这种信息, ** 一定要核验,一定要标来源,一定不要让 AI 裸奔。 **
用 minimax-pdf 生成 PDF
12
报告初稿有了,来源也整理好了。现在用斜杠调用 minimax-pdf 。
● ● ● /minimax-pdf
把 report/new-field-guide.md 生成一份适合小白阅读的未知领域入门 PDF 报告。
要求:
封面清爽专业。
正文有标题层级、概念解释和入门地图。
保留来源链接。
如果它问你风格,你可以说:
● ● ● 风格偏清爽、专业、适合小白阅读。
不要太花哨。
要像一份可以发给团队看的调研报告。
minimax-pdf 更适合你想把内容变成一个 ** 正式交付物 ** 的时候用。封面、目录、标题层级、表格、页边距,这些东西会让报告 ** 从“聊天记录”变成“文件”。 **
但也别神化它。如果你的 Markdown 结构很乱,来源不清,标题层级乱飞,它也很难凭空救回来。所以前面的计划、资料、报告结构, ** 不是多余步骤,它们是在给最后的 PDF 铺路。 **
就是这一下,很爽。因为你终于看见了 ** 一个文件 ** ,不是一屏对话,不是一段复制出来的文字,而是 ** 一个可以保存、发送、归档的 PDF。 **
这也是很多人第一次真正意识到: ** 原来 Claude 不只是回答问题,它可以帮我完成一整条生产线。 **
最后复盘:工作区有什么文件
13
跑完整个流程之后,我们回头看一下工作区。它可能长这样:
● ● ● new-field-research-demo/
├─ .claude/
│ └─ agents/
│ ├─ researcher.md
│ ├─ fact-checker.md
│ └─ report-writer.md
├─ plans/
│ └─ new-field-research-plan.md
├─ research/
│ ├─ raw-notes.md
│ └─ sources.md
├─ report/
│ └─ new-field-guide.md
└─ output/
└─ new-field-guide.pdf
如果你配置了项目级 MCP,可能还会出现:
● ● ● .mcp.json
但如果没有,也完全正常。
每个文件夹都对应一件事: plans/ 是 ** 计划 ** , research/ 是 ** 资料 ** , report/ 是 ** 正文 ** , output/ 是 ** 交付物 ** , .claude/agents/ 是 ** 子代理 ** , .mcp.json 是 ** 项目级 MCP 配置文件 ** 。
这棵文件树,其实就是你这次学习的成绩单。 ** 不是概念背了多少,而是你真的跑通了一条工作流。 **
你真正学会的是一条工作流
14
我们再把今天的流程串一下:
先在桌面建文件夹,用 Trae 打开它,再在 Trae 终端启动 Claude Code。接着安装 Superpowers 和 minimax-pdf。用 /brainstorming 问清楚需求,自动进入 /writing-plans 落成计划文件,再用 /dispatching-parallel-agents 让多个子代理分头搜资料、核验、整理,最后用 /minimax-pdf 生成 PDF。
你看,工作区、Skills、MCP、子代理这些词, ** 突然就不吓人了。 **
现在你至少知道了: ** 工作区管文件和上下文,Skills 管流程,MCP 管外部连接,子代理管分工,minimax-pdf 管最后的 PDF 交付。 **
小白真正要学的,不是所有功能,而是: ** 一条能跑通、能复用、能留下成果的工作流。 **
今天你用它调研“具身智能”,明天可以换成“低空经济”,后天可以换成“脑机接口”“合成生物学”“出海电商”“某个新行业”。 ** 主题会变,但方法不变。 **
主题会变,但工作流不变:
** 先澄清。再计划。再分工。再落盘。再交付。 **
这五个动作,才是最值钱的。
最后给你一个行动建议
15
** 不要收藏吃灰。今天就拿一个自己的小需求跑一遍。 **
不用很高级,比如“帮我搞懂低空经济”“帮我入门具身智能”“帮我快速理解一个我完全没接触过的行业”“帮我做一份某领域小白入门报告”。
重点不是第一份 PDF 有多完美。 ** 重点是你第一次看见 Claude 从聊天框,变成了工作台。 **
你不需要一口气学会所有功能。
** 你只需要先做成一件事。 **
** 先做出来。再做漂亮。 **
**
**
**
**
**
**
以上,既然看到这里了,
如果觉得不错,随手 点个赞、在看、转发 三连吧,
如果想第一时间收到推送,也可以给我个星标⭐~
谢谢你看我的文章
你的关注是我持续更新的动力~